home *** CD-ROM | disk | FTP | other *** search
/ C & C++ Multimedia Cyber Classroom / C and C++ Multimedia Cyber Classroom (Prentice Hall) (1998).iso / jre115s.exe / jre1.1.5 / README < prev   
Text File  |  1997-11-24  |  19KB  |  449 lines
  1.  
  2.                              README
  3.  
  4.                   The Java(tm) Runtime Environment
  5.                            JRE 1.1.5  
  6.  
  7. -----------------------------------------------------------------------
  8. CONTENTS
  9.  
  10.   Overview of Java Runtime
  11.     - Introduction
  12.     - The Java Runtime Interpreter
  13.     - Required vs. Optional Files
  14.     - Win 32 Files 
  15.        - Required Files
  16.        - Optional Files
  17.     - Solaris Files 
  18.        - Required Files
  19.        - Optional Files
  20.  
  21.   Bundling and Running the Java Runtime
  22.     - Bundling the Java Runtime
  23.     - Java Runtime Example
  24.     - Runtime Documentation
  25.  
  26.  
  27. =======================================================================
  28.                         OVERVIEW OF JAVA RUNTIME
  29. =======================================================================
  30.  
  31. -----------------------------------------------------------------------
  32. INTRODUCTION
  33. -----------------------------------------------------------------------
  34.  
  35. This is version 1.1.5 of the Java Runtime Environment, also known as 
  36. the Java Runtime, or JRE.  The Java Runtime is the minimum standard
  37. Java Platform for running Java programs.  It contains the Java 
  38. Virtual Machine, Java Core Classes and supporting files. 
  39.  
  40. The JRE can be invoked from the command line by using the jre tool 
  41. (see the following section). On Windows platforms, the jre tool will 
  42. ignore the CLASSPATH environment variable. For both Windows and 
  43. Solaris platforms, the -cp option is recommended to specify an 
  44. application's class path.
  45.  
  46. This document uses the term "vendors" to refer to licensees, 
  47. developers, and independent software vendors (ISVs) who 
  48. license and distribute the JRE with their Java programs.
  49.  
  50. The Win32 version of JRE 1.1.5 has an installer suitable for use 
  51. by end-users. This gives software developers the option of not 
  52. bundling the JRE with their applications. Instead, they can direct 
  53. end-users to download and install the JRE themselves.
  54.  
  55. An installer is not available for Solaris versions of the JRE. 
  56. Developers should bundle the JRE and an installer with their Solaris 
  57. applications. 
  58.  
  59. The JRE includes all of the non-debuggable .dll or .so files plus
  60. the necessary classes from the JDK 1.1.5 to support a runtime-only 
  61. program.  The JRE does not include any of the development tools
  62. (such as appletviewer or javac) or classes that would pertain only 
  63. to a development system.
  64.  
  65. Vendors must follow the terms of the JRE Binary Code License agreement, 
  66. which includes these terms:
  67.  
  68.  - Don't arbitrarily subset the JRE. You may omit only the
  69.    files listed below as optional. 
  70.  
  71.  - Include in your product's license the provisions called out
  72.    in the JRE Binary Code License.
  73.  
  74. Comments regarding the JRE are welcome. Please send them to 
  75. jre-comments@java.sun.com. Due to the large volume of email received 
  76. each day, JavaSoft usually cannot respond to your email personally.
  77.     
  78. The JRE is a product of Sun Microsystems, Inc.  
  79. JavaSoft is an operating company of Sun, and develops the JRE.
  80.  
  81.  
  82. -----------------------------------------------------------------------
  83. THE JAVA RUNTIME INTREPRETER
  84. -----------------------------------------------------------------------
  85.  
  86. The jre tool invokes the Java Runtime interpreter for executing Java 
  87. applications. The tool is available in the Win32, Solaris-Sparc, and 
  88. Solaris x86 downloads of the JRE. The syntax for the jre command is:
  89.  
  90.     jre [ options ] classname <args>
  91.  
  92. The classname argument is the name of the class file to be 
  93. executed. Any arguments to be passed to the class must be placed 
  94. after the classname on the command line.
  95.  
  96. An alternative version of the tool, jrew, is available for Win32. The 
  97. jrew command is identical to jre, except that a console window is not 
  98. invoked. The syntax of the jrew command is 
  99.  
  100.     jrew [ options ] classname <args>
  101.  
  102. On Windows platforms, the jre tool will ignore the CLASSPATH 
  103. environment variable. For both Windows and Solaris platforms, the 
  104. -cp option is recommended to specify an application's class path.
  105.  
  106. Options for the jre and the jrew commands are as follows:
  107.  
  108.    -classpath path    Specifies the path that jre uses to 
  109.                look up classes. Overrides the default 
  110.                classpath.  
  111.  
  112.    -cp path        Prepends the specified path to the default 
  113.                classpath that jre uses to look up classes. 
  114.  
  115.    -help        Print a usage message.
  116.  
  117.    -mx x        Sets the maximum size of the memory allocation 
  118.                pool (the garbage collected heap) to x. The 
  119.                default is 16 megabytes of memory. x must be
  120.             greater than or equal to 1000 bytes.
  121.  
  122.    -ms x        Sets the startup size of the memory allocation 
  123.                pool (the garbage collected heap) to x. The 
  124.                default is 1 megabyte of memory. x must be
  125.             greater than 1000 bytes.
  126.  
  127.    -noasyncgc        Turns off asynchronous garbage collection. When 
  128.                activated, no garbage collection takes place 
  129.                unless it is explicitly called or the program 
  130.             runs out of memory.
  131.  
  132.    -noclassgc        Turns off garbage collection of Java classes. 
  133.                By default, the Java interpreter reclaims space 
  134.                for unused Java classes during garbage collection.
  135.  
  136.    -nojit        Specifies that any JIT compiler should be 
  137.             ignored. The default Java interpreter is invoked.
  138.  
  139.    -ss x        The -ss option sets the maximum stack size that 
  140.                can be used by C code in a thread to x. The 
  141.             default units for x are bytes. The value of x 
  142.             must be greater than or equal to 1000 bytes.
  143.  
  144.    -oss x        The -oss option sets the maximum stack size 
  145.             that can be used by Java code in a thread to x. 
  146.             The default units for x are bytes. The value of 
  147.             x must be greater than or equal to 1000 bytes.
  148.  
  149.    -v, -verbose        Causes jre to print a message to stdout each 
  150.             time a class file is loaded.
  151.  
  152.    -verify        Performs byte-code verification on the class 
  153.             file. Beware, however, that java -verify does 
  154.             not perform a full verification in all 
  155.             situations. Any code path that is not actually 
  156.             executed by the interpreter is not verified. 
  157.             Therefore, java -verify cannot be relied upon to 
  158.             certify class files unless all code paths in 
  159.             the class file are actually run.
  160.  
  161.    -verifyremote    Runs the verifier on all code that is loaded 
  162.             into the system via a classloader. verifyremote 
  163.             is the default for the interpreter.
  164.  
  165.    -noverify        Turns verification off.
  166.  
  167.    -verbosegc        Causes the garbage collector to print out 
  168.             messages whenever it frees memory.
  169.    
  170.    -DpropName=value    Defines a property value. propName is the name 
  171.             of the property whose value you want to change 
  172.             and value is the value to change it to. For 
  173.             example, the command 
  174.             java -Dawt.button.color=green ...
  175.             sets the value of the property awt.button.color 
  176.             to "green".
  177.  
  178.  
  179. -----------------------------------------------------------------------
  180. REQUIRED vs. OPTIONAL FILES
  181. -----------------------------------------------------------------------
  182.  
  183. Licensees must follow the terms of the accompanying LICENSE.  
  184. The files that make up the JRE are divided into two categories:
  185. required and optional.  To paraphrase that license, files that 
  186. are marked "optional" here do not need to be included with the 
  187. licensee's program.
  188.  
  189. The term "required" means licensees who distribute the runtime 
  190. must include those files with their program, whether or not their 
  191. program ever uses those files.  Those files are a required part of 
  192. the Java Platform.
  193.  
  194. Most of the optional files provide localization support for languages.
  195.  
  196. The JRE includes the bin and lib directories which both must
  197. reside in the same directory.  We call this directory <runtime-dir>.
  198.  
  199. In the following lists, all paths are relative to the <runtime-dir>
  200. directory (which is originally "jre1.1.5").
  201.  
  202. -----------------------------------------------------------------------
  203. WIN32 FILES
  204. -----------------------------------------------------------------------
  205.  
  206. Two versions of JRE 1.1.5 for Win32 are available. One version contains 
  207. files for internationalization support. The version with 
  208. internationalization support contains all the files listed below under 
  209. both the REQUIRED FILES and OPTIONAL FILES subsections. A smaller 
  210. version of the Win32 JRE is available that does not contain those 
  211. optional files that provide interna